Deprecate gtk_widget_send_expose()

We have various replacements for what this function does, and we are not
calling it internally any more.

diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index f9a37c64af285427797033f674aad5b45a9c3e24..e6dfac7ef1c61f859e44068cb4d7907df467416a 100644 (file)
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -7522,8 +7522,13 @@ gtk_cairo_transform_to_window (cairo_t   *cr,
  * with a call to gdk_window_process_updates().
  *
  * Returns: return from the event signal emission (%TRUE if
- *               the event was handled)
- **/
+ *   the event was handled)
+ *
+ * Deprecated: 3.22: Application and widget code should not handle
+ *   expose events directly; invalidation should use the #GtkWidget
+ *   API, and drawing should only happen inside #GtkWidget::draw
+ *   implementations
+ */
 gint
 gtk_widget_send_expose (GtkWidget *widget,
                        GdkEvent  *event)

diff --git a/gtk/gtkwidget.h b/gtk/gtkwidget.h
index 863d70d9c5eb46119a2fe7fb91128709e8c1fb7f..c550ddaa24da1eaa914378ee747bd8422e973904 100644 (file)
--- a/gtk/gtkwidget.h
+++ b/gtk/gtkwidget.h
@@ -741,7 +741,7 @@ gboolean   gtk_widget_mnemonic_activate   (GtkWidget           *widget,
 GDK_AVAILABLE_IN_ALL
 gboolean   gtk_widget_event              (GtkWidget           *widget,
                                           GdkEvent            *event);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_22
 gint       gtk_widget_send_expose         (GtkWidget           *widget,
                                           GdkEvent            *event);
 GDK_AVAILABLE_IN_ALL